Startup parameters

You can use a number of different startup parameters to simplify your work.

Here is a short overview:

/dblocation PATH

This parameter will determine which folder will eM Client load the main database from. If the given folder does not exist, eM Client will create the folder and a new, empty database in it. Without this parameter, eM Client will load the database from the currently set default location.

 

/localmutex

Use this parameter when deploying the application in a Remote Desktop Services or Terminal Services environment where accessing global mutexes (short for „mutual exceptions“ in programming) is forbidden – the application will use local ones instead.

 

/mailurl RECIPIENT

Use this parameter to create a new message with a pre-defined email address compliant with RFC 6068. Example: MailClient.exe /mailurl "mailto:[email protected]?subject=hello&body=bodytext".

 

/open PATH

With this parameter you can open any .eml, .msg, .vcf, or .ics file in eM Client.

 

/newmail

This parameter will open a window to compose a new mail.

 

/newcontact

This parameter will open a window to create a new contact.

 

/newevent

This parameter will open a window to plan an event.

 

/newtask

This parameter will open a window to create a new task.

 

/importsettings PATH [-s] [-p PASS]

This parameter defines a file which contains eM Client settings and its password, which needs to be used to import the data. It needs to be an .XML file and can contain application settings, account configuration, templates, quicktexts, and rules. PATH is the location of the file. The rest of the parameter options are optional. [-s] stands for „silent“ and means that the settings will be imported without opening the UI. [-p PASS] is for inserting the password, if there is one protecting the file.

Example: MailClient.exe /importsettings "c:\Temp\settings.xml" -s -p MyPassword

 

/activate

If this parameter is used on startup, eM Client will try to activate a license. For activation to be possible eM Client needs to have a LastActivationKey entry in its database with a valid Activation key. Usually, the LastActivationKey value is set using the /importsettings parameter.